# ExiledBot2 for Path of Exile 2

### IMPORTANT NOTICE
Be aware that using this bot is against the PATH OF EXILE 2 TERMS OF SERVICE agreement and it may lead to your account being banned. While bans are relatively rare these days, you should still take precautions to minimize risks.

### RISK REDUCTION STRATEGIES
- **DO NOT USE** the bot on your main account if you care about it
- Limiting bot usage to less than 6-8 hours per day significantly reduces ban risks
- The more people are playing, the less likely your account is going to be caught, so avoid botting in end of leagues or period where not much people play the game
- Take breaks between bot sessions to mimic natural human play patterns

## System Requirements
### Software Dependencies
- DirectX End-User Runtime
  - [Official Download](https://www.microsoft.com/en-US/download/details.aspx?id=35)
  - [Mirror](https://workupload.com/file/VREuB9S48bd)
- Visual C++ 2017 Redistributable Package (x64)
  - [Official Download](https://aka.ms/vs/15/release/vc_redist.x64.exe)
  - [Mirror](https://workupload.com/file/8ccMDmbamcq)

## ⚠️ IMPORTANT SETUP REQUIREMENTS
Before starting the bot, follow these setup steps:

## Controls
- F12: Pause/Unpause
- F7: Generate inventory dump (while bot is paused)
- START/STOP: Reload all settings

### System Setup
1. Make sure that Windows display scaling is set to 100% (Settings > System > Display > Scale and layout)
   - This is crucial as other scaling values will cause the bot to missclick
2. Run the bot as administrator
   - If using injection mode, the target process should preferably be run as administrator
   - Note that many processes may crash or reject DLL injection. You'll need to experiment to find compatible processes
3. Ensure POE2 maintains 30+ FPS

### Game Settings
4. Set game language to English (only supported language)
5. In Options->Interface, enable "Always Highlight"
6. In Options->Game, set Key Pickup to either "Use Bound Key" or "Use Highlight Key" (strongly recommended to prevent misclicks on loot)
7. Ensure "Toggle Highlighting" is bound to any key of your choice in game settings
   - This feature is essential as the bot uses it to get unstuck when having trouble picking up items
8. Disable all loot filters in game
9. Use mouse-click movement mode in game
10. Bind a skill to "Move Only" in POE2 (e.g., key 'T')
11. Ensure the stash tab that you are using for currencies is last in the stash tabs list
12. Ensure that you don't have any mtx effect on Town and Map Portals

### Stash Tab Requirements
- **DO NOT USE STASH TAB FOLDERS** - The bot cannot find items inside folders and will show errors like "Couldn't find element for item: xxx" in logs
- **DO NOT USE MTX MAP STASH TABS** - The bot does not support MTX map stash tabs
- The stash tab indexes defined in map tabs configuration must be a regular stash tabs
- Keep all tabs at the root level without any folder organization

### Bot Configuration
13. In Main Tab, set your movement key (ie T or R) as your Movement key - DO NOT use left mouse click for movement as this will cause frequent misclicks and getting stuck
14. If using Rhoa followers, ensure any Rhoa MTX skins are disabled, the bot requires the default Rhoa appearance to function properly

After completing these setup steps, explore the bot's tabs (Status, Main, Map, Pickit, Combat, Client) to configure detailed settings. Each option has a tooltip that explains its function - simply hover your mouse over any setting to learn more.

## Current Features
- World area navigation
- Combat and monster elimination
- Party system for coordinated multi-bot gameplay with automatic invitation management and follower coordination
- Waystone farming with configurable tier and rarity settings
  - Rare monsters hunting with automatic detection from minimap
  - Waystone crafting support
  - Waystone instillation system - automatically instill waystones with distilled emotions before running waystones (configure via config.ini with enable_waystone_instillation and distilled_emotions_slot1/2/3 settings)
  - Precursor tablet system with tower influence (enable by setting enable_tower_influence=true in config.ini, not available in GUI)
  - Tablet pickup limit based on stash count (configure tablet_in_stash_limit in pickit.ini)
  - Precursor Beacon activation
- Area exploration with proper instance reset
- Item management
  - Stashing (regular and currency tabs)
  - Item selling, salvaging and disenchanting
  - Smart pickit to automatically collect, identify and keep items based on your custom rules
  - WeightedSum function for advanced pickit configuration (combines multiple mods with custom weights)
  - Any orbs usage on waystones (e.g., [Rarity] == "Rare" # [ExaltIfPossible] == "5" sets target of 5 mods)
- Hideout handling (mandatory for waystones farming)
- Flask system
  - Automatic flask usage and emergency logout when Life/ES/Mana drops below configurable thresholds
  - Run-only autoflask mode available
- Shrine, Essence, Breach and Delirium activation
- Recovery system with automatic relog for repetitive actions instead of exiting (configure max_recovery_attempts in config.ini)

## Resolution Support
- Designed with 1920x1080 resolution but works with other resolutions
  - Fixed UI interactions (town portal, resurrection) for all resolutions
- May not work properly with extremely low resolutions (e.g., 800x600) or non-16:9 aspect ratios

## Known Limitations
⚠️ The following features have issues:
- No dodge mechanics
- Atlas navigation may fail if the camera is zoomed in. Make sure to fully zoom out the atlas map view before letting the bot navigate it
- If the bot has trouble with stash tabs, reset stash tabs to their original order from when you first logged into your account

## Finding Correct Mod Names for Pickit
To ensure you're using the correct mod names in your pickit configuration:
1. Place the item(s) with the desired mods in your inventory
2. Start the bot and pause it
3. Press F7 to generate a dump
4. Check the `Logs/dump.log` file for item details
5. Look for the mod names that now appear directly in the dump
6. Reference these mods in `modslist.html` (which includes indexes for easier searching)

For example, if your `dump.log` shows the mod name directly, you can look it up in `modslist.html` to find its exact name format for use in the pickit configuration.

**Note**: The `modslist.html` file contains all possible mod IDs and their human-readable descriptions. Use the exact ID from this list when configuring your pickit rules.

## Party Mode Setup

The bot supports coordinated multi-bot gameplay through an automated party system. This allows multiple bots to work together with one acting as leader and others as followers.

### Configuration
All party settings are configured in the `[party]` section of `config.ini`:

**For Party Leader Bot:**
```ini
[party]
party_mode=1
follower_names=Follower1|Follower2|Follower3
leader_wait_distance=250
map_farming=true
```

**For Party Follower Bots:**
```ini
[party]
party_mode=2
leader_name=LeaderCharacterName
leader_follow_range=40
map_farming=true
```

### Settings Explanation
- `party_mode`: 0=Disabled, 1=Leader (sends invites), 2=Follower (accepts invites)
- `leader_name`: Character name of the party leader (used by followers only)
- `follower_names`: Pipe-separated list of follower character names (used by leader only)
- `leader_follow_range`: Distance followers maintain from leader (default: 40)
- `leader_wait_distance`: Distance at which leader waits for followers (default: 250)
- `map_farming`: Enable hideout-portal coordination for map farming (default: true)

### How It Works
- **Leader bot** automatically invites configured followers and waits for them when they fall behind
- **Follower bots** automatically accept invites from the configured leader and follow them between areas
- **Ensure that each bot starts from either its own hideout or the leader's hideout**
- **Manual play integration**: You can play manually as the leader character and have bot(s) follow you by setting the follower bot's leader_name to your character name, then manually inviting the bot character to your party after starting the bot
- **Followers will engage in combat** when they are within range of the leader and detect enemies, or when monsters are within emergency range for self-defense
- In map farming mode, followers will follow the leader through hideout → portal → map workflow
- Party coordination takes priority over other bot activities to ensure smooth cooperation
- Each bot can have individual combat settings configured in the Combat tab for skills, flasks, and behavior

## Community
- Report bugs and suggest features on our [Discord](https://discord.gg/BeKCcXjKCm)
- Visit our [Official Website](http://www.exiled-bot.net/)